# Remote access

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# SSH remote terminal

> The Linux system has built-in ssh-server service and can be connected directly.

## **Get IP address of Quectel Pi H1 smart single-board computer**

Enter the `ip address` command in the debug UART terminal to view the IP address of Quectel Pi H1.

```{image} images/image_FUPUbWMhAopG6rxdKw4c28Xfnkb.webp
:width: 771px
:height: 224px
```

## Configure SSH login

Enter the following command in the Windows console. You need to enter "**yes**" to confirm the connection during the connection process.

```bash
ssh <username>@<ip-address># Examplessh pi@192.168.2.xxx  
```

```{image} images/image_ObBRbZ831oillgxeUpxcNve7nvh.webp
:width: 831px
:height: 378px
```

You can also use the **PuTTY** terminal software tool to enter the IP address of Quectel Pi H1 to log in.  
 

```{image} images/image_ILxDbcvwyo5hmWxQAW9cs6Iunkh.webp
:width: 528px
:height: 520px
```

Enter the username and password of Quectel Pi H1. The default user is pi.

```{image} images/image_YvdQbhBZuoucAAxDMbrcX1JRnCe.webp
:width: 642px
:height: 341px
```

# VNC remote desktop

The **Linux** system already has built-in **tigervnc server** service, which can be used directly.

## Set VNC password

Enter the following command on the device terminal:

```bash
#Follow the prompts to enter the password twice in a rowmkdir ~/.vnc
vncpasswd -f > ~/.vnc/passwd
```

## Create a startup script

Enter the following command on the device terminal:

```bash
# Create the scriptcat > start_xvnc.sh << 'EOF'
#!/bin/bash
echo "Cleaning up previous sessions..."
pkill -9 -f xfce
pkill -9 -f xfwm4
pkill -9 -f Xvnc
sleep 2

echo "Starting VNC server..."
Xvnc :1 -geometry 1280x720 -depth 24 -rfbport 5901 -rfbauth ~/.vnc/passwd &
sleep 5

export DISPLAY=:1

echo "Starting window manager (without compositing)..."
xfwm4 --display=:1 --compositor=off &
WM_PID=$!
sleep 3

if ps -p $WM_PID > /dev/null;  then
echo "Window manager started successfully (PID: $WM_PID)"
else
echo "Failed to start window manager"
exit 1
fi

echo "Starting XFCE4 session..."
startxfce4 &
sleep 5

echo "Desktop components status:"
ps aux | grep -E "(xfce|xfwm|xfsettings|xfdesktop|xfce4-panel)" | grep -v grep
EOF# Modify permissionschmod +x start_xvnc.sh
```

## Manage commands

```bash
# Start VNC
./media/start_xvnc.sh

# Stop VNCpkill -9 -f xfce
pkill -9 -f xfwm4  
pkill -9 -f Xvnc

# View statusps aux | grep vnc
netstat -tln | grep 59
```

## Test connection

```bash
# Connect from another computer, and enter the password as prompted to log in# For example, vncviewer 10.66.82. *: 5901
Vncviewer<Device IP Address>: 5901
```

- After successful connection, you will see the following screen.

```{image} images/image_ZJrCbd94FoUW7DxGk6kc7yYFnRb.webp
:width: 1280px
:height: 752px
```